home *** CD-ROM | disk | FTP | other *** search
/ USA Bestseller / USA BESTSELLER Vol 1-95 (Hepp-Computer)(1995).iso / e124 / list.doc < prev    next >
Text File  |  1988-09-28  |  62KB  |  1,689 lines
  1. 
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                             LIST  Version 6.4a
  21.  
  22.                             September 21, 1988
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                    (c) Copyright  Vernon D. Buerg 1983-88
  59.                            All rights reserved
  60.  
  61.             T A B L E   O F   C O N T E N T S
  62.  
  63. __________________________________________________________________________
  64.  
  65.  
  66.  Description of Use  ................................................... 1
  67.       Introduction  .................................................... 1
  68.       Command line format  ............................................. 1
  69.       Installation  .................................................... 1
  70.  
  71.  How to use LIST  ...................................................... 2
  72.  
  73.  Commands and Keys  .................................................... 4
  74.       Cursor keys  ..................................................... 4
  75.       Letter keys  ..................................................... 4
  76.       Control- keys  ................................................... 5
  77.       F- function keys  ................................................ 5
  78.       Alt- keys  ....................................................... 6
  79.  
  80.  Scrolling  ............................................................ 8
  81.  
  82.  Positioning to Lines  ................................................. 9
  83.  
  84.  Displaying multiple files  ............................................ 10
  85.  
  86.  Marking and Extracting Lines  ......................................... 11
  87.  
  88.  Display Format  ....................................................... 12
  89.      Status Line Format  ............................................... 12
  90.      Command Line Format  .............................................. 13
  91.  
  92.  Screen Colors  ........................................................ 14
  93.  
  94.  Scanning for text  .................................................... 15
  95.  
  96.  Filtering  ............................................................ 16
  97.       Hi-bit Filter  ................................................... 16
  98.       Star Filter  ..................................................... 16
  99.       Junk Filter  ..................................................... 16
  100.       Hex Format Filter  ............................................... 16
  101.  
  102.  DOS considerations  ................................................... 17
  103.       File Sharing  .................................................... 17
  104.       Invoking DOS Commands  ........................................... 17
  105.       Screen Saving  ................................................... 17
  106.  
  107.  Cloning Procedure  .................................................... 18
  108.  
  109.  Modifying LIST  ....................................................... 19
  110.       Locations of clonable values  .................................... 19
  111.       Reassigning keys  ................................................ 20
  112.       Routine ID values  ............................................... 21
  113.  
  114.  Restrictions  ......................................................... 23
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. Contents 1                                             LIST  User's Guide
  125. Description of Use
  126. ______________________________________________________________________________
  127.  
  128.  
  129.     Introduction
  130.  
  131.         You use LIST to display files on your monitor, line by line
  132.         with the aid of scrolling, positioning and filtering commands.
  133.  
  134.  
  135.     Command line format
  136.  
  137.         The command line format is:
  138.  
  139.  
  140.         LIST [filespec...filespec] [/S][/J][/7][/8][/*][/W][/H][/L]
  141.  
  142.  
  143.         where filespec is one or more names of files and the optional  /
  144.         switches are:
  145.  
  146.                 /S       indicates viewing a piped or redirected file
  147.                 /J       sets Junk filter on
  148.                 /7       sets 7-bit display
  149.                 /8       sets 8-bit display
  150.                 /*       sets star filter on
  151.                 /W       sets Wrap on
  152.                 /H       sets Hex dump mode
  153.                 /L       sets pre-Loading on
  154.  
  155.         The command line switch character is normally a slash, "/",
  156.         but LIST will use whatever character that is defined to DOS
  157.         as the command line switch character, e.g. a dash, "-".
  158.  
  159.  
  160.     Installation
  161.  
  162.         Copy LIST.COM to your working disk, and into the directory
  163.         that is most convenient.
  164.  
  165.         You may rename the program file to any convenient name, such
  166.         as L.COM, READ.COM, etc.
  167.  
  168.         To print the documentation, set your printer for six lines per
  169.         inch, and 10 characters per inch.  Then, use the DOS PRINT
  170.         command.  For example,
  171.  
  172.                         PRINT LIST.DOC
  173.  
  174.         The documentation file is marked with | before new and changed
  175.         lines.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182. LIST  User's Guide                                                    Page  1
  183. How to use LIST
  184. ______________________________________________________________________________
  185.  
  186.  
  187.             Using LIST is fairly straightforward.  You type the  command
  188.         LIST, at the  DOS prompt, followed  by the name(s)  of the files
  189.         that  you  want  to  see.   For  example:  LIST CONFIG.SYS would
  190.         display the file CONFIG.SYS.
  191.  
  192.             Once the file is displayed  on your screen, you may  use the
  193.         cursor positioning keys to  move around and see  different parts
  194.         of the file.  For example,  when LIST first starts, you  see the
  195.         first 23 lines of the file.  To see the next 23 lines, or  page,
  196.         press the PgDn key.   The PgUp key moves  you back one page  and
  197.         shows you the  previous 23 lines.   The up-arrow and  down-arrow
  198.         keys move it one line at  a time.  When you are finished,  press
  199.         the ESCape key and you are returned to the DOS prompt.
  200.  
  201.             The "filename" is optional.  If omitted, you are prompted to
  202.         enter a filename.  You may  include drive, path, and wild  cards
  203.         in the  file name.   The first  file which  matches that name is
  204.         displayed.  After  the file  is displayed,  the next  file which
  205.         matches the "filename" may be displayed, too.
  206.  
  207.             You may also use LIST to display piped or redirected  files.
  208.         If you are unfamiliar with these, you may skip to the next page.
  209.  
  210.             To display  a redirected  file, use  a <  (less than symbol)
  211.         before the name of the file  that was redirected and add the  /S
  212.         parameter to the LIST command.   For example, the output of  the
  213.         DIR command can be written to  a file called XYZ, and then  LIST
  214.         can be instructed to read that file.
  215.  
  216.                 dir a: >xyz
  217.                 list <xyz /s
  218.  
  219.             To display a piped file,  omit the filename, but supply  the
  220.         /S.
  221.  
  222.                 dir a: | list /s
  223.  
  224.         Or, to LIST a file within an ARC archive:
  225.  
  226.                 arc /p arcname.arc filename.ext | list /s
  227.                                 - or -
  228.                 arce arcname filename.ext /p | list /S
  229.  
  230.  
  231.             Because files  contain different  kinds of  data, there  are
  232.         several commands  to tell  LIST how  to display  the data.   The
  233.         process that LIST uses to make the file data readable is  called
  234.         filtering.  The filters in LIST can:
  235.  
  236.             o  replace non-text and control characters with blanks
  237.             o  expand TAB characters
  238.             o  display line drawing characters
  239.             o  change 8-bit (W*) data to readable 7-bit text
  240.             o  display the hexidecimal values for each character
  241.             o  remove "junk", such as control codes and backspaces
  242.  
  243.             LIST was designed  to display ASCII  files.  That is,  files
  244.         which  contain  text,  and  not  binary  or control codes.  Text
  245.         characters usually  range from  a value  of 32  to 127.  To view
  246.  
  247. Page  2                                                    LIST  User's Guide
  248. How to use LIST
  249. ______________________________________________________________________________
  250.  
  251.         binary  files  (COM,  EXE,  etc),  the  alt-H (hex dump display)
  252.         command is available.
  253.  
  254.  
  255.             Characters  below  32  (a  blank)  are replaced with a funny
  256.         character to indicate that a non-displayable character has  been
  257.         encountered.  This  character is  an upside-down  question mark.
  258.         Characters above 127 may be valid graphic characters, and may be
  259.         displayed  if  the  '8'  command  is  in effect.  To insure that
  260.         characters above ASCII value 127 are not displayed, use the  '7'
  261.         command.
  262.  
  263.  
  264.             The top  line of  the display  gives the  file name, current
  265.         right  scroll  offset,  and  the  FILE's creation date and time.
  266.         Optionally, a ruler  may be displayed  on the top  line by using
  267.         the alt-R keys.
  268.  
  269.             The  file  is  displayed  with  one  logical  record on each
  270.         display line: usually 80 characters.  A logical record ends in a
  271.         linefeed and  may be  up to  910 characters  long.  If  a record
  272.         exceeds 80 characters,  you may view  the portion beyond  the 80
  273.         columns by using the scroll right command, or by using the  Wrap
  274.         feature.  The Wrap (W) command toggles ON or OFF the wrapping of
  275.         lines  longer  than  80  characters.   With  Wrap  on, lines are
  276.         displayed in  their entirety,  80 characters  per display  line.
  277.         The scroll left (arrow) and right (arrow) functions are disabled
  278.         when Wrap is ON.
  279.  
  280.         The file may be PRINTed as it it displayed.  The P command
  281.         toggles the printer on or off.  When first entered, the P
  282.         command causes the current screen  to be printed.  As new  lines
  283.         are displayed, they too are printed.  Printing may be stopped by
  284.         entering another P command.  The PrtSc key may also be used, but
  285.         the title and prompt lines will be printed with the lines of the
  286.         file.  Empty lines  cause a line  to be skipped  on the printer.
  287.         The  letter  P  is  displayed  on  the bottom command line while
  288.         printing.   See  the  section  on  extracting  lines  for  other
  289.         methods.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312. LIST  User's Guide                                                    Page  3
  313. Commands and Keys
  314. ______________________________________________________________________________
  315.  
  316.  
  317.     Cursor keys
  318.  
  319.         Cursor key    Function
  320.         -----------   -----------------------------------------------
  321.         left arrow    scroll left 10 columns
  322.         right arrow   scroll right 10 columns
  323.         up arrow      up one (previous) line
  324.         down arrow    down one (next) line
  325.  
  326.         Enter         continue to next page
  327.         END           position to end of file (bottom)
  328.         ESCape        Exit program unconditionally
  329.         HOME          restart from first line (top)
  330.         PgUp          scroll up one page, 23 lines
  331.         PgDn          scroll down one page, 23 lines
  332.  
  333.  
  334.     Letter keys
  335.  
  336.         Letter(s)     Default   Function
  337.         ---------     -------   ----------------------------------------
  338.         A                       find next occurrence of 'text' (Again)
  339.         B                       skip to end of file (Bottom)
  340.         C               off     toggles Continuous scrolling
  341.         D                       scroll Down one page
  342.         F                       Find 'text' regardless of case
  343.         G                       Get new filename/filespec (also alt-F)
  344.         H or ?                  Help, show command list
  345.         K               off     toggle Keyboard flush; if on, commands
  346.                                 may be queued up by holding a key down
  347.         L                       scroll Left 10 columns
  348.         M               on      toggle test for display retrace, if on
  349.                                 the display is faster but may flicker;
  350.                                 not applicable to monochrome monitors
  351.         N                       down one (Next) line
  352.         P               off     toggle Printer on or off
  353.         Q                       Quit, display next file, or exit if only
  354.                                 one file is being viewed
  355.         R                       scroll Right 10 columns
  356.         S                       Scan for exact text match, case dependent
  357.         T                       restart from first line (Top)
  358.         U                       scroll Up one page (23 lines)
  359.         W               off     toggle Wrap of lines over 80 chars
  360.         X                       terminate, clear screen and eXit to DOS
  361.         Z                       like ctl-PgUp, displays previous file
  362.  
  363.         7               off     turn off high bit (non-graphics only)
  364.         8               on      leave high bit on (graphics)
  365.         *               off     toggles special * document filtering
  366.  
  367.         +                       position a given number of lines forwards
  368.         -                       position a given number of lines backwards
  369.  
  370.         \text                   Find any case 'text' going forwards
  371.         /text                   Scan exact case 'text' going forwards
  372.  
  373.         ` or ^                  Find any case 'text' going backwards
  374.         ' or v                  Find exact case 'text' going backwards
  375.  
  376.  
  377. Page  4                                                    LIST  User's Guide
  378. Commands and Keys
  379. ______________________________________________________________________________
  380.  
  381.  
  382.     Control- keys
  383.  
  384.         Control key     Function
  385.         -----------     ---------------------------------------------------
  386.  
  387.         ctl-HOME        positions to a specific line number
  388.  
  389.         ctl-PgUp        display previous file (review)
  390.         ctl-PgDn        display next file (or exit if only one file)
  391.  
  392.         ctl-left-arrow  reset horizontal scroll position to column 1
  393.  
  394.         ctl-A           scroll full left
  395.         ctl-C           next page
  396.         ctl-D           scroll right
  397.         ctl-E           former line
  398.         ctl-N           display next file
  399.         ctl-R           former page
  400.         ctl-S           scroll left
  401.         ctl-U           display previous file
  402.         ctl-W           former line
  403.         ctl-X           next line
  404.         ctl-Z           next line
  405.  
  406.  
  407.     F- function keys
  408.  
  409.         Function key    Function
  410.         ------------    ---------------------------------------------------
  411.  
  412.          F1             Help - display summary of commands
  413.  
  414.          F3             Find next occurrence of text after Scan or Find
  415.  
  416.          F9             Find previous occurrence of text after Scan or Find
  417.  
  418.          F10            Exit to DOS with clear screen and cursor last line
  419.  
  420.  
  421.          F2             change background color for Find/Scan text
  422.          F4             change foreground color for Find/Scan text
  423.  
  424.          F5             change background color for main body of display
  425.          F6             change foreground color for main body of display
  426.  
  427.          F7             change background color for top and bottom lines
  428.          F8             change foreground color for top and bottom lines
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442. LIST  User's Guide                                                    Page  5
  443. Commands and Keys
  444. ______________________________________________________________________________
  445.  
  446.  
  447.     Alt- keys
  448.  
  449.         The Alt- key commands are entered by pressing the Alt key at the
  450.         same time as you press one of the following letter keys:
  451.  
  452.  
  453.     alt- letter      Function
  454.     -----------      ---------------------------------------------------
  455.  
  456.      alt-A           toggle on if you are using APXCOREA; off (default)
  457.                      if using DesqView or DoubleDos
  458.  
  459.      alt-B           mark bottom line
  460.  
  461.      alt-C           clone LIST.COM, change colors or options permanently,
  462.                      in a new copy of the LIST.COM program file
  463.  
  464.      alt-D           toggle dump mode: if no lines are marked, the current
  465.                      screen only is written to the specified file; if lines
  466.                      are marked, they are written to the dump file.
  467.  
  468.      alt-E           toggle 25/43 line display (does test for EGA). If the
  469.                      actual EGA lines is not 25 or 43, don't use alt-E
  470.  
  471.      alt-F           prompt for new Filespec or filename to display
  472.                      entering a leading asterisk (*) may be obscured
  473.                      by some console enhancers or utilities, so enter
  474.                      two asterisks, e.g. **.doc
  475.      alt-G           Shell to DOS, invoke COMMAND.COM, requires 96k or more.
  476.                      Use the DOS EXIT command to return to LIST.
  477.  
  478.      alt-H           toggles hex dump formatted display
  479.  
  480.      alt-J           toggle adding line feed to lone carriage returns
  481.                      and remove backspaces, overlaying previous characters
  482.  
  483.      alt-L           toggles preloading of files; default is OFF
  484.                      When the file is pre-loaded, the number of the
  485.                      last line number becomes known.
  486.  
  487.      alt-M           mark top line; marked lines may be printed or written
  488.                      to the alt-D dump file.
  489.  
  490.      alt-N           toggles screen saving feature; with screen saving
  491.                      disabled, the minimum memory required is about 38k
  492.  
  493.      alt-O           like alt-D, writes marked lines to a file using the
  494.                      filename from the previous alt-D command
  495.  
  496.      alt-R           toggles display of a ruler on the top line
  497.  
  498.      alt-S           toggles file Sharing option, when off
  499.                      files remain open until program termination
  500.  
  501.      alt-T           toggles expansion of TAB control characters, the
  502.                      tab columns are a multiple of 8, i.e. 1,9,17, etc.
  503.                      The default is to expand TABs. See DEBUG section.
  504.  
  505.      alt-U           unmark lines; line marks are removed
  506.  
  507. Page  6                                                    LIST  User's Guide
  508. Commands and Keys
  509. ______________________________________________________________________________
  510.  
  511.  
  512.      alt-W           toggles split screen; when ON, the top half of
  513.                      the screen is frozen. Further scrolling occurs
  514.                      only in the bottom half of the screen (window)
  515.                      until the alt-W keys are used again.
  516.  
  517.      alt-Y           repositions the file to the last "active" line;
  518.                      that is a line positioned to by Find/Scan, or
  519.                      by alt-M/alt-B marking of lines.
  520.  
  521.      alt-X           exits to DOS and displays the original screen
  522.                      (unless screen saving has been disabled)
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572. LIST  User's Guide                                                    Page  7
  573. Scrolling
  574. ______________________________________________________________________________
  575.  
  576.  
  577.             You view different parts of the file by scrolling.  That is,
  578.         you use the cursor positioning keys up, down, left and right  to
  579.         move the display one increment in that direction.  For  example,
  580.         press the down  arrow key to  move the display  one line in  the
  581.         file, i.e. display the next line in the file.
  582.  
  583.             The  PgDn  and  PgUp  cursor  keys  move the display on full
  584.         screen in either direction.
  585.  
  586.  
  587.             Rather than press the up  and down keys once for  each line,
  588.         you  may  use  continuous  scrolling.   Use  the C key to toggle
  589.         continuous  scrolling  on  or  off.   The  default is off.  When
  590.         toggled on,  pressing the  up or  down arrow  keys results  in a
  591.         moving display.  For example, when you press the down arrow, the
  592.         next  line  of  the  file  is  displayed automatically every few
  593.         moments.  It is  like holding down  the arrow key.   To stop the
  594.         continuous scroll, press the space bar.
  595.  
  596.  
  597.             The  speed  of  the  continuous  scroll  can  be adjusted by
  598.         pressing the  + (plus)  or -  (minus) key  while the  display is
  599.         moving.  The  plus key  makes the  display move  faster, and the
  600.         minus key makes it move slower.  You can save the speed value by
  601.         using the cloning command (see Alt-C).
  602.  
  603.  
  604.         Summary of scrolling commands:
  605.  
  606.             right arrow - move display right 10 columns
  607.             left arrow  - move display left 10 columns
  608.             down arrow  - display next line of file
  609.             up arrow    - display previous line of file
  610.             PgUp key    - display previous "page", 23 (or 41) lines back
  611.             PgDn key    - display next "page", 23 (or 41) lines ahead
  612.  
  613.             C key       - turns continuous scrolling on or off
  614.             spacebar    - or any key, interrupts continuous scrolling
  615.             + (plus)    - makes continuous scroll incrementally faster
  616.             - (minus)   - makes continuous scroll slower
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637. Page  8                                                    LIST  User's Guide
  638. Positioning to Lines
  639. ______________________________________________________________________________
  640.  
  641.  
  642.             Each displayable line of the file is assigned a line number.
  643.         The first line is assigned line number 1.  The highest allowable
  644.         line  number is 16 million.  In order to determine the last line
  645.         number, the  entire file  must be  read.  For  this reason,  the
  646.         first time that the END (bottom) command is issued, it will take
  647.         longer to process.  This is  not necessary if the file  has been
  648.         completely read (see the alt-L preloading option).
  649.  
  650.             If the Wrap  option is in  effect, there is  one line number
  651.         required for  each 80  bytes of  the file's  records.  Thus, the
  652.         line number does not represent the actual number of lines in the
  653.         file.
  654.  
  655.             If  the  hex  dump  option  is  in effect, there is one line
  656.         number required for each 16 bytes of the file.  For example,  an
  657.         80-byte file will be displayed as 5 lines.
  658.  
  659.             You may  position to  a specific  line number  by using  the
  660.         c-Home, Ctrl key  and Home key,  or the #  key.  When c-Home  is
  661.         entered, you are prompted for the line number.  Enter the 1 to 5
  662.         digit line number.   The display will  now begin with  that line
  663.         number at the top of the screen.
  664.  
  665.             To position forward or backward,  you may use the +  (plus),
  666.         or -  (minus) keys.   You are  prompted to  enter the  number of
  667.         lines to  be skipped.   The display  resumes at  the line number
  668.         shown on  the top  (status) line,  plus or  minus the  number of
  669.         lines that you specified.
  670.  
  671.             When you  change a  filter option,  such as  Wrap, the  line
  672.         numbering changes.  An attempt is  made to retain the same  file
  673.         position, but the file may be repositioned at the top.
  674.  
  675.  
  676.         Summary of positioning commands:
  677.  
  678.         ctrl-HOME, or #  - prompts for exact line number to display
  679.         + (plus)         - prompts for the number of lines to skip
  680.                            for positioning further ahead in the file
  681.         - (minus)        - prompts for the number of lines to skip
  682.                            for positioning to an earlier line
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. LIST  User's Guide                                                    Page  9
  703. Displaying multiple files
  704. ______________________________________________________________________________
  705.  
  706.  
  707.             You can display more than one file by supplying wildcards in
  708.         the file name.  For example,  LIST *.DOC will display all  files
  709.         with an extension of DOC.
  710.  
  711.             To  display  the  next  file,  you  use  the  Q or ctrl-PgDn
  712.         command.  When the  last file has  been displayed, you  can exit
  713.         LIST by using the X,  F10, ESCape, or alt-X commands,  depending
  714.         on how you want the screen to look when LIST ends.
  715.  
  716.             To display the previous file, you use the ctrl-PgUp (control
  717.         and PgUp keys together).  LIST can keep track of up to 20  files
  718.         at one time.  The line number for each file is also remembered.
  719.  
  720.             Another way to LIST more than  one file is to use the  alt-F
  721.         command.  Alt-F asks you for a new file name, and you may  enter
  722.         a simple file name, or one that includes wild cards.  These  new
  723.         file names are added to the table of filenames that LIST  keeps.
  724.         Thus, you can use alt-F for several different filenames, and use
  725.         the ctrl-PgDn and ctrl-PgUp commands to move among them.
  726.  
  727.  
  728.         Summary of file review commands:
  729.  
  730.         ctrl-PgUp       - display previous file
  731.         ctrl-PgDn       - display next file
  732.  
  733.         alt-F           - prompt for new filename or filespec to display
  734.  
  735.         ESCape          - exit to DOS
  736.         Q               - display next file; if none, exit to DOS
  737.                           leaving the last page on the screen
  738.         X               - exit to DOS with a blank screen
  739.         F10             - exit to DOS with a blank screen
  740.         alt-X           - exit to DOS and display the screen that was
  741.                           present when LIST was invoked
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767. Page  10                                                    LIST  User's Guide
  768. Marking and Extracting Lines
  769. ______________________________________________________________________________
  770.  
  771.  
  772.             There are two ways that lines can be extracted from a file:
  773.  
  774.               o  with the P (print) command, and
  775.               o  with the alt-D (dump data) command.
  776.  
  777.             The lines to  be extracted are  either the current  lines on
  778.         the screen,  or lines  that you  have marked  with the alt-M and
  779.         alt-B commands.
  780.  
  781.             To mark lines, you use  either the alt-M or alt-B  commands.
  782.         The alt-M command  marks the top  line on the  screen, and alt-B
  783.         marks the bottom line on the screen.  You can use either or both
  784.         commands to mark the starting and ending lines (in the range  of
  785.         lines  to  be  extracted).   The  marked  lines are displayed in
  786.         reverse video.
  787.  
  788.             After  you  have  marked  a  range  of  lines, you use the P
  789.         (print) command to print all  of the marked lines.  Or,  you can
  790.         use the  alt-D (dump  data) command  to write  those lines  to a
  791.         file.  The alt-D command asks you for a file name.  If the  file
  792.         does not  exist, a  new one  is created.   If the  file  already
  793.         exists, the extracted lines are added (appended) to the file.
  794.  
  795.             For example, you would like  to have LIST filter out  all of
  796.         the junk in a file, and then write a new file.  To do this,  you
  797.         might enter the following sequence of commands:
  798.  
  799.                 list TESTDATA           ... display your TESTDATA file
  800.                 alt-J                   ... filters out the junk
  801.                 alt-M                   ... marks line 1 (top line)
  802.                 END                     ... positions to end of file
  803.                 alt-B                   ... marks the bottom line
  804.                                                      (last line)
  805.                 alt-D                   ... dumps data to a file
  806.                 TESTDATE.NEW            ... you enter the new file name
  807.                 alt-X                   ... quit and return to DOS
  808.  
  809.  
  810.             Once you have marked a range of lines, use of alt-M or alt-B
  811.         does not reset the entire line range.  The first or last  marked
  812.         line may  change, but  both do  not change.   Using alt-M  again
  813.         expands or contracts the  range appropriately.  If the  new line
  814.         for alt-M/alt-B is before the  top mark, the top mark  is moved.
  815.         If the new  line is after  the bottom mark,  the bottom mark  is
  816.         changed.  If the new line is within the currently marked  range,
  817.         alt-M moves the top mark - contracts the range - and alt-B moves
  818.         the bottom mark.
  819.  
  820.  
  821.             Use  the  alt-U  command  to  unmark lines, especially after
  822.         alt-D (dump) to be sure.
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832. LIST  User's Guide                                                    Page  11
  833. Display Format
  834. ______________________________________________________________________________
  835.  
  836.  
  837.             The  monitor  display  is  defined  in  terms  of  lines and
  838.         columns.  A typical monitor can  display 25 lines of 80  columns
  839.         each.  LIST attempts to use the number of lines and columns  for
  840.         the monitor mode in use.  For  example, if the monitor is in  40
  841.         column mode, LIST displays only 40 characters per line.  And, if
  842.         the monitor is set  for other than 25  lines, such as 35  or 43,
  843.         LIST uses that number of lines.
  844.  
  845.             If you use  the alt-E command  to change EGA  modes, the EGA
  846.         palette,  cursor,  and  other  settings  are  set to DOS default
  847.         values.  LIST does not preserve fonts or palettes.
  848.  
  849.             The top line of the display is called the Status line.   The
  850.         bottom line is called the Command line.  The remaining lines are
  851.         called the  primary display  window, and  are usually  lines two
  852.         through 24.
  853.  
  854.  
  855.    Status Line Format
  856.  
  857.         The Status line has the following format:
  858.  
  859.                 LIST   lllll nnnnnnn +sss mm/dd/yy hh:mm  - filename
  860.  
  861.         where,
  862.  
  863.         'LIST'     is the name of this program
  864.  
  865.         'lllllll'  is the line number of the first line in the
  866.                    display window (usually on line 2)
  867.  
  868.         'nnnnnnn'  is the line number of the last record, if known
  869.  
  870.         '+sss'     if displayed, this is the Scroll amount, in
  871.                    multiples of 10, corresponding to the number
  872.                    of columns that the display has been shifted
  873.                    to the right to view records longer than 80
  874.  
  875.         'mm/dd/yy' is the file's creation date (not today's date)
  876.         'hh:mm'    is the file's creation time (not today's time)
  877.  
  878.  
  879.         Note:      The date and time  shown on the top line is  NOT  the
  880.                current date.  It is the date and time  that the file was
  881.                created.
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897. Page  12                                                    LIST  User's Guide
  898. Display Format
  899. ______________________________________________________________________________
  900.  
  901.  
  902.    Command Line Format
  903.  
  904.         The Command line has the following format:
  905.  
  906.       command message _________ Toggles: hbkmpswtalj Keys: X=exit ?=Help
  907.                                           -----------
  908.         where,
  909.  
  910.         'command' indicates the current process:
  911.  
  912.           'Command'   function prompt; you are being asked to enter
  913.                        a command; enter the letter, or press the keys
  914.                        for the action to be performed
  915.  
  916.           'Reading '   the file data is being read
  917.           'Filter  '   the file data is being formatted for display
  918.           'Looking '   the Scan/Find text is being searched for
  919.  
  920.           'Scan   '   you are being asked to enter text to locate
  921.           'Find   '   in the file, up to 31 characters may be entered
  922.  
  923.           '# lines?'   you are being asked to enter a 1 to 5 digit
  924.                        number that is the amount of lines to skip
  925.  
  926.           'Line #? '   you are being asked to enter a 1 to 5 digit
  927.                        line number to which the display is to be
  928.                        positioned
  929.  
  930.  
  931.         'message' may be one of:
  932.  
  933.           '*** Text not found ***'
  934.            the Scan/Text was not found in the file
  935.  
  936.           '   *** Top of file ***'
  937.            the first line of the file is being displayed
  938.  
  939.           '   *** End-of-file ***'
  940.            the last line of the file is being displayed
  941.  
  942.         Toggles: indicate status of toggles, lower case means OFF, upper
  943.         case means the option is ON.
  944.  
  945.         'H'       indicates that the hex Dump display option is in use
  946.         'b'       the 'b' is replaced by a 7, 8, or * depending
  947.                   on which of those options is in effect
  948.         'K'       indicates that the Keyboard flush option is in use
  949.         'M'       indicates that tests for monitor retrace are not made
  950.         'P'       indicates that Print is in use
  951.         'C'       toggles continuous scrolling
  952.  
  953.         'W'       indicates that the Wrap mode is in effect
  954.         'T'       indicates that TAB characters are expanded
  955.         'A'       indicates APXCORE interface, 'a' for TV/DV/DD
  956.         'L'       indicates that the pre-loading option is on
  957.         'J'       indicates that line feeds are added to lone carriage
  958.                   return control characters, and backspaces are handled
  959.  
  960.  
  961.  
  962. LIST  User's Guide                                                    Page  13
  963. Screen Colors
  964. ______________________________________________________________________________
  965.  
  966.  
  967.             The screen's lines may be in any of three different colors:
  968.  
  969.                 o  the 'special' color for the top status line and the
  970.                    bottom command line
  971.                 o  the 'normal' color for the file's text windows
  972.                 o  the 'bright' color for lines with Find/Scan text,
  973.                    and for the upside-down question mark in 7-bit mode
  974.  
  975.             There is  a pair  of function  keys assigned  to each color.
  976.         You use these function keys at any time to change the background
  977.         and  foreground  colors  temporarily,  or  use the alt-C cloning
  978.         command to make the  colors permanent.  Alt-C requires  that the
  979.         LIST.COM program file be on the current drive and in the current
  980.         directory unless you are using DOS version 3.3  or  later.  With
  981.         DOS 3.3, the program file may have  any name  and may  reside in
  982.         any subdirectory.
  983.  
  984.            The border is not  changed.  The foreground color  applies to
  985.         the color of the characters.
  986.  
  987.         The color attributes may be changed by using these function keys:
  988.  
  989.           For the main body of text:
  990.  
  991.                 F5 - background color
  992.                 F6 - foreground color
  993.  
  994.           For the top and bottom lines:
  995.  
  996.                 F7 - background color
  997.                 F8 - foreground color
  998.  
  999.           For the line with Find/Scan text:
  1000.  
  1001.                 F2 - background color
  1002.                 F4 - foreground
  1003.  
  1004.             Once you  have decided  upon the  colors, use  the alt-C key
  1005.         combination to change the LIST.COM program file.
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027. Page  14                                                    LIST  User's Guide
  1028. Scanning for text
  1029. ______________________________________________________________________________
  1030.  
  1031.  
  1032.             You may use Find (\ or  F) to search for text regardless  of
  1033.         the case, or you may use Scan  (/ or S) to find an exact  match.
  1034.         The search begins  at the top  line displayed and  proceeds in a
  1035.         forward direction until the end of file.  You may start a search
  1036.         that goes backwards  rather than forwards  by using the  ` (left
  1037.         quote) key  instead of  Find (\),  or by  using '  (right quote)
  1038.         instead of Scan (/).
  1039.  
  1040.             To scan for a character string, type a slash (/) followed by
  1041.         one or more (up to 31)  characters.  The Scan text, but not  the
  1042.         slash,  is  displayed  on  the  command  line.  The Scan is case
  1043.         sensitive.  That is, lower case Scan text will only match  lower
  1044.         case file text.
  1045.  
  1046.             While  the  program  is  searching  for the text, the bottom
  1047.         display line  is changed  to say  "Scanning".  Pressing  ANY key
  1048.         while the search  is in progress  will terminate the  search and
  1049.         display the message 'Text not found' on the bottom line.
  1050.  
  1051.             If the text is found, the line containing it is displayed as
  1052.         a high-intensity line (bright color) in the middle of the screen
  1053.         depending on the value of the Find Row (see cloning section).
  1054.  
  1055.             If the text is NOT  found, the command line (25)  is changed
  1056.         to  say  '***  text  not  found  ***',  and  the display remains
  1057.         unchanged.
  1058.  
  1059.             To find the next occurrence of the same text, use the A)gain
  1060.         command, or press the F3 key.  To find the previous  occurrence,
  1061.         press the F9 key.
  1062.  
  1063.             If the PCED keyboard  enhancement program is installed,  the
  1064.         up/down cursor keys  may be used  to recall and  edit previously
  1065.         entered Scan/Find text.
  1066.  
  1067.             In  a  shared  file  environment,  if the file changes while
  1068.         being listed,  the file  position may  become invalid.   Use the
  1069.         HOME command to insure proper file synchronization,   or use the
  1070.         alt-S command again.
  1071.  
  1072.             If the display has been  scrolled right or left so  that the
  1073.         "found"  text  is  not  visible,  you  will  see  an upside-down
  1074.         question mark in the first column.  This is the same symbol that
  1075.         is  displayed  on  a  blank  line  while  changing the Find/Scan
  1076.         colors.  It  is there  so that  you can  tell that  the line  is
  1077.         marked.
  1078.  
  1079.         Summary of scanning commands:
  1080.  
  1081.                 /       Scan for text with exact match
  1082.                 v or '  Scan for text going backwards
  1083.  
  1084.                 \       Find text with case insensitive search
  1085.                 ^ or `  Find case insensitive text going backwards
  1086.  
  1087.                 F3      Find next occurrence of text
  1088.                 F9      Find previous occurrence of text
  1089.  
  1090.  
  1091.  
  1092. LIST  User's Guide                                                    Page  15
  1093. Filtering
  1094. ______________________________________________________________________________
  1095.  
  1096.  
  1097.             Filtering is the term used to describe the process that LIST
  1098.         uses to  format file  data for  displaying on  a monitor.  After
  1099.         data  is  read  from  a  file,  it  is  filtered.  The method of
  1100.         filtering depends upon the options in effect.
  1101.  
  1102.             For a typical ASCII  text file, the filter  removes carriage
  1103.         return and line feed characters, and expands TAB characters.
  1104.  
  1105.  
  1106.  
  1107.     Hi-bit Filter
  1108.  
  1109.             The  7,  8,  and  *  (asterisk)  commands  determine whether
  1110.         characters above ASCII-127 are displayed.  If the hi-bit  option
  1111.         is off (7  command), the filter  strips the high  order bit from
  1112.         each character.   If the  hi-bit option  is on  (8 command), all
  1113.         characters, including  graphic characters  above ASCII-127,  are
  1114.         displayed.
  1115.  
  1116.  
  1117.     Star Filter
  1118.  
  1119.             The  star  (*  or  asterisk)  command  displays  only  ASCII
  1120.         characters below 128 (x'80'), but treats the special  characters
  1121.         x'8A'  and  x'8D'  as  line-feed  and  carriage-return   control
  1122.         characters.   Any  other  characters  above  127  are treated as
  1123.         spaces, and control codes below ASCII-26 are replaced by blanks.
  1124.  
  1125.             The Wrap option causes the filtering to insure that no  line
  1126.         exceeds the width of the monitor, e.g. 80 characters.
  1127.  
  1128.  
  1129.     Junk Filter
  1130.  
  1131.             The alt-J  command toggles  the "junk"  filter which insures
  1132.         that carriage  returns in  the file  also result  in a new line.
  1133.         Also, backspace characters result in "backing up" the display by
  1134.         one position.  This  allows more readability  of files that  use
  1135.         backspacing to emphasize, or over-write, characters.
  1136.  
  1137.  
  1138.  
  1139.     Hex Format Filter
  1140.  
  1141.             The hex dump option (alt-H) causes the filtering to reformat
  1142.         the file  data into  a DEBUG-like  display format.   The largest
  1143.         file that can be displayed in Hex is 1 million bytes.
  1144.  
  1145.             An  attempt  is  made  to  retain  the  file  position  when
  1146.         switching from normal to hex-dump display, but due to  filtering
  1147.         changing record lengths,  the hex display  may begin before  the
  1148.         current record.
  1149.  
  1150.         NOTE:   The  EOF  control character is  ignored in this version.
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157. Page  16                                                    LIST  User's Guide
  1158. DOS considerations
  1159. ______________________________________________________________________________
  1160.  
  1161.  
  1162.     File Sharing
  1163.  
  1164.             LIST uses  two techniques  for allowing  you to  share files
  1165.         with   other   processes,   such   as   programs   running under
  1166.         multi-tasking systems, in other windows, or on networks.
  1167.  
  1168.             The first technique is called "file closing" and is  enabled
  1169.         by the  alt-S commands.   This forces  LIST to  close the viewed
  1170.         file unless it needs to read from the file.  If enough memory is
  1171.         available, the entire file may be loaded once and thus leave the
  1172.         file free for exclusive access by other processes.
  1173.  
  1174.             The  second  technique  is  called  "file sharing".  It is a
  1175.         function of  DOS and  requires DOS  version 3.0  or later.  LIST
  1176.         opens the viewed  files with a  DENY NONE request.   This allows
  1177.         other processes to  read and write  to the file  if they do  not
  1178.         request exclusive use of the  file.  If a file is  not available
  1179.         to  LIST  because  it  is  locked  by  another process, you will
  1180.         receive the error message "File not found" or "Access  denied".
  1181.         There is  no command  to enable  or disable  this method of file
  1182.         sharing.  It is implicit with the use of DOS version 3.
  1183.  
  1184.  
  1185.     Invoking DOS Commands
  1186.  
  1187.             If the  "goto DOS"  option is  enabled, you  may invoke  DOS
  1188.         commands by using the alt-G command.  LIST reserves about 60k of
  1189.         memory  for   its  own   use.   This   increases  LIST's  memory
  1190.         requirements  to  approximately  96k  when  using  alt-G.    The
  1191.         remaining memory is available to the DOS commands.
  1192.  
  1193.  
  1194.             After you have finished  entering DOS commands, use  the DOS
  1195.         EXIT command to return to LIST.
  1196.  
  1197.             To disable the  "goto DOS" function,  you must use  DEBUG to
  1198.         alter the option  byte described in  the section about  cloning.
  1199.         With it disabled, LIST requires less memory, about 66K.
  1200.  
  1201.  
  1202.     Screen Saving
  1203.  
  1204.             If  the  screen  saving  option  is  enabled, LIST saves the
  1205.         contents of the current display screen when it starts.  You  can
  1206.         restore  the  original  screen  by  exiting  LIST with the alt-X
  1207.         command.
  1208.  
  1209.             Screen saving requires approximately 10k more memory.   This
  1210.         is sufficient to save 60 lines of 80 characters (EGA 8x6  mode).
  1211.         See the section about cloning for information about enabling and
  1212.         disabling the screen saving feature.
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222. LIST  User's Guide                                                    Page  17
  1223. Cloning Procedure
  1224. ______________________________________________________________________________
  1225.  
  1226.  
  1227.             The screen colors, the display retrace testing (M), the file
  1228.         closing (C) and ruler (alt-R) options may be permanently set  in
  1229.         the program by using the alt-C cloning function.
  1230.  
  1231.             For  cloning  to  take  effect, the program should be called
  1232.         LIST.COM and on the current drive and in the current directory.
  1233.  
  1234.             There are two versions of the LIST program file.  One is the
  1235.         normal full program.  The  other, which  contains an  'S' as the
  1236.         last letter of  the file name,  is a slightly  smaller file that
  1237.         excludes  the  Help  screen.   You  may  use either COM file for
  1238.         cloning.  After cloning, you may continue viewing the file.
  1239.  
  1240.            The clonable options (command toggles) are:
  1241.  
  1242.              M      =  Mono monitor, affects retrace testing. If you see
  1243.                        "snow" on your color monitor, turn off this
  1244.                        option
  1245.  
  1246.              alt-S  =  file(s) are shared
  1247.              W      =  Wrap long lines
  1248.              8/7/*  =  display all 256 values, or 7-bit, or special case
  1249.              K      =  flush Keyboard each time a command is read
  1250.  
  1251.              alt-A  =  set on if using Apxcore, off if using Double Dos
  1252.                        or TopView, or DesqView
  1253.  
  1254.              alt-H  =  hex dump display, like the DEBUG format
  1255.  
  1256.              alt-J  =  toggle "junk" filter, add LF to CR, fix backspaces
  1257.  
  1258.              alt-L  =  set on to force preloading (reading) of the
  1259.                        entire file before any lines are displayed,
  1260.                        Default is OFF.
  1261.  
  1262.              alt-N  =  toggles screen saving (see alt-X) feature
  1263.  
  1264.              alt-R  =  toggle columnar ruler on top line
  1265.  
  1266.              alt-T  =  toggle expansion of TAB characters
  1267.  
  1268.  
  1269.         Note: Be  sure you  have no  other copies  of LIST.COM which are
  1270.         accessible (because of a filepath type of utility).
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287. Page  18                                                    LIST  User's Guide
  1288. Modifying LIST
  1289. ______________________________________________________________________________
  1290.  
  1291.  Locations of clonable values
  1292.  
  1293.  
  1294.            An alternative to cloning is  to use DEBUG to make  permanent
  1295.         changes.  Here is a list of key items and their addresses:
  1296.  
  1297.            0127 - special lines 1 and 25 colors, default is 01 (blue)
  1298.                   Refer to a technical reference guide for the
  1299.                   attribute values for the colors that you want.
  1300.            0129 - normal lines 2 thru 24 colors, default is 02 (green)
  1301.            012B - bright color for Find/Scan, default is 0F (bright white)
  1302.            012D - clonable options;
  1303.                MRSJ WHK*  M = mono, retrace testing if off, x'01'
  1304.                           R = ruler, x'02'
  1305.                           S = shared, x'04'
  1306.                           J = add LF to lone CR, process backspaces,
  1307.                               if on, x'08'; default is off
  1308.                           W = wrap mode, x'10'
  1309.                           H = hi-bit on, x'20'
  1310.                           K = kybd flush, x'40'
  1311.                           * = special document filtering, x'80'
  1312.            012E - more clonable options, not all are indicated:
  1313.                .PAT DGV.  P = Preload file if on, x'02', default is off
  1314.                           A = Apxcore if on, TV/DD/DV if off, x'04,
  1315.                               default is for Topview/Double DOS use
  1316.                           T = if on (default), expand TABs, x'08'
  1317.                           D = hex display mode if on, x'10'
  1318.                           G = if on, alt-G goto DOS is Disabled, x'20'
  1319.                           V = if on, screen save/restore is Disabled
  1320.                               and 9K less memory is used/required, x'40'
  1321.  
  1322.         By  specifying  the  bit  value,  the  option  is  enabled.  For
  1323.         example, to enable  Shared and Retrace,  specify a hex  value of
  1324.         the sum, or 01+04 = 05.
  1325.            012F - row less one at which found text is displayed,  1 byte
  1326.                   the default is 08 which displays found text on line  9
  1327.            0131 - scroll offset value,  default is 10 (x'0A'),  one byte
  1328.            0133 - scroll starting value, default is 0 (x'00'), one byte
  1329.            0135 - tab increment, must be power of 2, default is 8
  1330.            0137 - tab mask, subtract tab incr from FFFFh,default is FFF8
  1331.            0139 - beep tone, default is 512 (hex 0200)
  1332.  
  1333.             When  the  Find/Scan  command  is  used, the next line which
  1334.         contains that text is highlighted using the 'bright' color,  and
  1335.         is placed in  row 9 of  the screen.  You  can change the  row by
  1336.         altering the byte  at location 12F  which is normally  '08', one
  1337.         less than the row.
  1338.  
  1339.            0368 - WHAT eye-catcher
  1340.            036C - WHAT keys/function table (see below)
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352. LIST  User's Guide                                                    Page  19
  1353. Modifying LIST
  1354. ______________________________________________________________________________
  1355.  
  1356.  Reassigning keys
  1357.  
  1358.  
  1359.         This information is offered to  those of you who wish  to modify
  1360.         LIST in special ways.  You  do not need this information  to use
  1361.         LIST.
  1362.  
  1363.         LIST performs a function for every character that can be entered
  1364.         at the command  line prompt.  There  are 128 regular  characters
  1365.         and  131  extended  characters.   The  regular  characters   are
  1366.         numbered from 0 to 127,  and they include the letters  A-Z, a-z,
  1367.         the numbers, and the rest  of the usual single characters  found
  1368.         on  your  keyboard.   The  extended characters represent special
  1369.         function  keys  and  combinations  of  keys,  such as F1, alt-X,
  1370.         ctrl-A, and the cursor positioning keys.
  1371.  
  1372.         The  WHAT  table in LIST has  a one  byte entry  for each of the
  1373.         characters.  This byte is a number from 0 to 57 that  represents
  1374.         the identification of a routine that performs a function.
  1375.  
  1376.         For example,
  1377.  
  1378.           - the ESCape key has a value  of 27 (hex 1B) and its value  in
  1379.             the WHAT table is 16 (10 hex).  Routine number 16 is  called
  1380.             "Done".  The "Done" routine exits to DOS.
  1381.  
  1382.           - the Q key has a value of 81 (51 hex) with a routine value of
  1383.             15  for  the  "Close"  routine.   The  "Close"  routine ends
  1384.             viewing of the  current file and  tries to display  the next
  1385.             file, i.e. wildcards used for the filename.  There is also a
  1386.             lower case letter q, so be sure to change both entries.
  1387.  
  1388.  
  1389.         To change the  function that a  command character performs,  you
  1390.         change the  value in  the WHAT  table for  the routine  that the
  1391.         character invokes.
  1392.  
  1393.         For example, to change the ESCape key to act like the Q key, you
  1394.         change the routine value for ESCape from 16 (10 hex) to a 15 (0F
  1395.         hex).
  1396.  
  1397.         To find  the location  of the  routine value  in the WHAT table,
  1398.         first determine the value of  the character, e.g.  ESCape is  27
  1399.         (1B hex), and then  add that to the  location of the WHAT  table
  1400.         (36C hex); or, 1B + 36C = 387 hex.  Finally, use DEBUG to change
  1401.         the byte at that location (387 hex) from a 10 hex to a 0F hex.
  1402.  
  1403.         For example,
  1404.  
  1405.           debug list64a.com             ; use appropriate file name
  1406.           -e 387 0f                     ; change ESC to routine 15
  1407.           -w                            ; old data is 10
  1408.           -q
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417. Page  20                                                    LIST  User's Guide
  1418. Modifying LIST
  1419. ______________________________________________________________________________
  1420.  
  1421.  Routine ID values
  1422.  
  1423.  
  1424.     Value Key(s)    Title        Description of function performed
  1425.     ----- --------- ----------   ------------------------------------------
  1426.       0             Beeper       Error, undefined command
  1427.       1   alt-A     AltA         Toggle APXCORE/DD/TV interface
  1428.       2   alt-E     AltE         Toggle EGA 43-line mode
  1429.       3   alt-F     AltF         Get new filespec
  1430.       4   alt-J     AltJ         Toggle Junk filter
  1431.       5   alt-L     AltL         Toggle pre-Load
  1432.       6   alt-T     AltT         Toggle TABs expansion
  1433.       7   alt-W     AltW         Toggle Window
  1434.       8   alt-X     AltX         Exit to DOS, restore screen
  1435.       9   U/up      Back         Position to previous line
  1436.      10   End       Bottom       Position to end of file
  1437.      11   F5        ChgBack      Change top/bottom line background color
  1438.      12   F6        ChgFore      Change top/bottom line foreground color
  1439.      13   c-home    CHome        Position to specified line number
  1440.      14   alt-C     Clone        Rewrite LIST.COM with new options
  1441.      15   Q         Close        Quit current file, display next file
  1442.      16   ESC F10   Done         Exit to DOS
  1443.      17   N down    Down1        Position to next line
  1444.      18   X         DoneX        Exit to DOS, clear screen
  1445.      19   alt-H     DumpHex      Toggle Hex display mode
  1446.      20   8         Eight        Leave hi-bit
  1447.      21   \         Find         Search for text, any case matches
  1448.      22   F2        FindBack     Change Find/Scan background color
  1449.      23   F4        FindFore     Change Find/Scan foreground color
  1450.      24   alt-M     Flash        Toggle monitor rescan testing
  1451.      25   K         Flush        Toggle keyboard flush (type ahead)
  1452.      26   alt-G     GotoDOS      Invoke DOS command (shell)
  1453.      27   L left    Left         Scroll left 10 columns
  1454.      28   -         MinusNum     Position back by number of lines
  1455.      29   enter     NxtPage      Display next page
  1456.      30   +         PlusNum      Position forward by number of lines
  1457.      31   P         Print        Print current screen or marked lines
  1458.      32   F1 H ?    Help         Display Help screen
  1459.      33   F3        ReScan       Search for next occurance of text
  1460.      34   R right   Right        Scroll display right 10 columns
  1461.      35   alt-R     Ruler        Display ruler marks on top line
  1462.      36   /         Scan         Search for text, same case
  1463.      37   F9        ScanBack     Search for previous occurance of text
  1464.      38   c-left    Scroll0      Reset scroll to column 1, full left
  1465.      39   F7        SetBack      Change normal line background color
  1466.      40   F8        SetFore      Change normal line foreground color
  1467.      41   7         Seven        Strip hi-bit
  1468.      42   C         Share        Toggle closing of files
  1469.      43   *         Star         Toggle special * filter
  1470.      44   Home      Top          Position to top of file
  1471.      45     up      Up1          Position back one line
  1472.      46   W         Wrapper      Toggle display of wide lines
  1473.      47   alt-D     WriteFile    Write marked lines to a file
  1474.      48   alt-M     MarkLines    Mark top line of display
  1475.      49   alt-U     UnmarkLines  Unmark lines
  1476.      50   alt-B     MarkBottom   Mark bottom line of display
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482. LIST  User's Guide                                                    Page  21
  1483. Modifying LIST
  1484. ______________________________________________________________________________
  1485.  
  1486.  Routine ID values
  1487.  
  1488.     Value Key(s)    Title        Description of function performed
  1489.     ----- --------- ----------   ------------------------------------------
  1490.      51   ctrl-pgup Review       Display previous file
  1491.      52   ^         RevFind      Like Find but initiates search backwards
  1492.      53   v         RevScan      Like Scan but initiates search backwards
  1493.      54   alt-N     AltN         Toggle screen saving (alt-X) function
  1494.      55   C         Smooth       Toggle continuous scrolling
  1495.      56   alt-Y     AltY         Bookmark, reposition to last "active" line
  1496.      57   alt-O     WriteFile    Write marked lines to previous alt-D file
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547. Page  22                                                    LIST  User's Guide
  1548. Restrictions
  1549. ______________________________________________________________________________
  1550.  
  1551.  
  1552.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or  later,
  1553.         through DOS 3.3.  For personal use only; may not be sold.
  1554.  
  1555.           o  The program requires about 48K of memory. If more memory is
  1556.              available, it is used to store more of the file in  memory.
  1557.              At least 80K is required to  use the DOS shell.  Add 9K  if
  1558.              the screen saving option is enabled (default).
  1559.  
  1560.           o  The line number is currently limited to 16 million lines.
  1561.  
  1562.           o  The file size is limited to 16 million bytes for ASCII
  1563.              files, and to 4 million bytes for hex-dump files.
  1564.  
  1565.           o  PC DOS Version 2.0 or later is required. DOS version 3.0 or
  1566.              later is required for file sharing.
  1567.  
  1568.           o  ANSI.SYS is NOT required.
  1569.  
  1570.         APX Core, DesqView, TopView, Double DOS, and IBM are all copy-
  1571.         righted, trademarked, and all that.
  1572.  
  1573.         LIST is supplied for personal, private use.  Feel free to
  1574.         distribute LIST given these restrictions:
  1575.  
  1576.           o  the program shall be supplied in its original, unmodified
  1577.              form, which includes this documentation;
  1578.  
  1579.           o  no fee is charged;
  1580.  
  1581.           o  for-profit use without a license is prohibited;
  1582.  
  1583.           o  the program may not be included - or bundled - with other
  1584.              goods or services.  Exceptions may be granted upon written
  1585.              request only.  This applies to clubs and distributors, too.
  1586.  
  1587.  
  1588.         If you are  using LIST and find it of value, your gift in any
  1589.         amount ($15 suggested) will be greatly appreciated.  Please make
  1590.         checks payable in U.S. dollars to Vernon D. Buerg.  Canadian and
  1591.         non-U.S. checks are not acceptable.
  1592.  
  1593.         For use by corporations  and other institutions, please contact
  1594.         me for a licensing arrangement.  More information is supplied in
  1595.         the file LICENSE.  Customizing, licensing of the source, and
  1596.         other special licensing are available upon request.  Purchase
  1597.         orders and invoicing are acceptable.
  1598.  
  1599.  
  1600.                 Vernon D. Buerg
  1601.                 139 White Oak Circle
  1602.                 Petaluma, CA  94952
  1603.  
  1604.                 Data:   (707) 778-8944    VOR 24-hour bulletin board
  1605.                 - or -  (707) 778-8841    MB  24-hour bulletin board
  1606.                 Compuserve: 70007,1212
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612. LIST  User's Guide                                                    Page  23
  1613. Index-1                                                LIST  User's Guide
  1614. __________________________________________________________________________
  1615.  
  1616.  
  1617.  
  1618.   /*,command line,star filter .. 1, 18
  1619.   /7,command line,7-bit option . 1, 18
  1620.   /8,command line,8-bit option . 1
  1621.   /H,command line,hex option ... 1
  1622.   /J,command line,junk filter .. 1
  1623.   /L,command line,preload option 1
  1624.   /S,command line,piping option  1, 2
  1625.   /W,command line,wrap option .. 1
  1626.   Alt- keys .................... 6
  1627.   Alt-A,APXCORE option ......... 6, 18, 21
  1628.   Alt-B,mark bottom line ....... 6, 7, 11, 21
  1629.   Alt-C,clone new LIST.COM ..... 6, 8, 14, 18, 21
  1630.   Alt-D,Write marked lines ..... 6, 11, 21, 22
  1631.   Alt-E,toggle 25/43 lines ..... 6, 12, 21
  1632.   Alt-F,enter new filename ..... 4, 6, 10, 21
  1633.   Alt-G,go to DOS .............. 1, 6, 17, 19, 21
  1634.   Alt-H,toggle hex display ..... 3, 6, 16, 18, 21
  1635.   Alt-J,toggle junk filter ..... 6, 11, 16, 18, 21
  1636.   Alt-L,toggle file preloading . 6, 9, 18, 21
  1637.   Alt-M,mark top line .......... 6, 7, 11, 21
  1638.   Alt-N,toggle screen saving ... 6, 18, 22
  1639.   Alt-O,write marked lines ..... 6, 22
  1640.   Alt-R,toggle ruler display ... 3, 6, 18, 21
  1641.   Alt-S,toggle file sharing .... 6, 15, 17, 18
  1642.   Alt-T,toggle TAB expansion ... 6, 18, 21
  1643.   Alt-U,unmark lines ........... 6, 11, 21
  1644.   Alt-W,freeze top window ...... 7, 21
  1645.   Alt-X,exit to DOS ............ 1, 7, 10, 11, 17, 18, 20, 21, 22
  1646.   Alt-Y,reposition to last line  7, 22
  1647.   Cloning ...................... 8, 14, 15, 17, 18, 19
  1648.   Colors ....................... 6, 14, 15, 18, 19
  1649.   Command line format .......... 1, 13
  1650.   Command line,option switches . 1, 3, 12, 13, 14, 15
  1651.   Continuous,scrolling ......... 4, 8, 13, 22
  1652.   Control- keys ................ 5
  1653.   Cursor keys .................. 4, 15
  1654.   DEBUG,changing options ....... 6, 16, 17, 18, 19, 20
  1655.   Exit to DOS .................. 4, 5, 10, 21
  1656.   F- function keys ............. 5
  1657.   File Sharing ................. 17, 23
  1658.   Find,text .................... 4, 5, 7, 13, 14, 15, 19, 20, 21, 22, 23
  1659.   Hex dump,display mode ........ 1, 3, 6, 13, 16, 18
  1660.   Hex Format Filter ............ 16
  1661.   Hi-bit Filter ................ 16
  1662.   Hi-bit,filter ................ 16, 19, 21
  1663.   Installation ................. 1
  1664.   Introduction ................. 1
  1665.   Invoking DOS Commands ........ 17
  1666.   Junk Filter .................. 16, 21
  1667.   Junk,filter .................. 1, 2, 11, 16, 18, 21
  1668.   Letter keys .................. 4
  1669.   License,information .......... 23
  1670.   LISTS.COM,small version ...... 1
  1671.   Piped,piping files ........... 1, 2
  1672.   Print,files or lines ......... 1, 11, 13, 21
  1673.   Scan,for text ................ 4, 5, 7, 13, 14, 15, 19, 21, 22
  1674.  
  1675. LIST  User's Guide                                                 Index-2
  1676. __________________________________________________________________________
  1677.  
  1678.  
  1679.  
  1680.   Screen saving,option ......... 6, 7, 17, 18, 22, 23
  1681.   Shell,to DOS ................. 1, 6, 21, 23
  1682.   Star Filter .................. 16
  1683.   Star,filter .................. 1, 16, 21
  1684.   Status Line Format ........... 12
  1685.   Switches,command line ........ 1
  1686.   TAB,control character ........ 2, 6, 13, 16, 18, 19
  1687.  
  1688. 
  1689.